efa vcenter debug

A set of debug commands for troubleshooting XCO vCenter issues. This command also sets configuration parameters for vCenter tenants.

Syntax

efa vcenter debug tenant show --host string

Shows a list of tenants for a particular VMware vCenter server host.

efa vcenter debug event show --host string [ --page int32 | --page-size int32 ]

Shows a list of events recorded for a particular VMware vCenter server host.

efa vcenter debug setting show

Shows the different settings configured on the VMware vCenter server host. These settings are global in nature and are applicable to all VMware vCenter Server hosts registered with this XCO vCenter Service instance.

efa vcenter debug setting update [ --poll-frequency string | --dead-link-clearing-time string ]

Updates the different settings for the added VMware vCenter server hosts registered with this XCO vCenter Service instance. These settings are applicable to all the VMware vCenter Server hosts.

efa vcenter debug set --level [ info | debug ]

Sets the debug level for this instance of XCO vCenter service. Debug levels can be set to receiving information level messages or complete debugging messages.

Command Default

This command has no defaults.

Parameters

--host string: IP address or hostname of the VMware vCenter Server to connect to.
--page int32: Events are fetched for the page number specified in this parameter. When this parameter is not passed, page number 1 is always fetched by default.
--page-size int32: The number of events to display per page. When this parameter is not passed, twenty (20) records are shown per page.
--poll-frequency string: The poll duration in hours. The XCO vCenter Service polls all the VMware vCenter servers registered with it after this time duration has expired.
--dead-link-clearing-time string: The time duration in days. This is the time duration for which dead links are removed from the XCO vCenter service database.
--level [ info | debug ]: Sets the debug level for this XCO vCenter service instance. Can be one of info or debug. Use info to view only messages of the level info. Use debug to view all debug messages.

Examples

This following example returns the debug information for tenant creation failure (and any other reported errors) for a vCenter server with IP address 10.24.85.111. This example shows only a portion of the possible output.

$ efa vcenter debug tenant --host 10.24.85.111
Tenant Configuration Details for vCenter 10.24.85.111
+----------------------+-------+--------+-----------------+-------------------------------------------------+
| Tenant Name          | Ports | VLANs  | Status          | Reason                                          |
+----------------------+-------+--------+-----------------+-------------------------------------------------+
| vcenter-10.24.85.111 |       | 2-4089 | Creation Failed | Tenant vcenter-10.24.85.111 is missing the      |
|                      |       |        |                 | following interfaces: 10.25.225.46="ethernet-0/5"
+----------------------+-------+--------+-----------------+-------------------------------------------------+
Tenant Details

EPG Configuration Details for vCenter 10.24.85.111 
+-------------------------------------------------------+-------------------+-----------------+
| EPG Name                                              | Ports             | Switchport Mode |
+-------------------------------------------------------+-------------------+-----------------+
| vCenter_10.24.85.111_10.24.82.20_vSwitch1_VMNetwork2  | 10.24.82.20[0/11] | trunk           |
+-------------------------------------------------------+-------------------+-----------------

This example shows the vCenter service settings.

$ efa vcenter debug setting show

vCenter service settings
+----------------------+------------------------------+
| Poll Frequency Hours | Dead Link Clearing Time Days |
+----------------------+------------------------------+
| 4                    | 3                            |
+----------------------+------------------------------+

This example shows tenant and endpoint group information for the specified IP address.

$ efa vcenter debug tenant --host 10.24.85.111

+----------------------+-------+--------+----------------------+--------+
|     Tenant Name      | Ports | VLANs  |        Status        | Reason |
+----------------------+-------+--------+----------------------+--------+
| vcenter-10.24.85.111 |       | 2-4089 | Created Successfully |        |
+----------------------+-------+--------+----------------------+--------+
Tenant Details

EPG Configuration Details for vCenter 10.24.85.111
+----------+-------+-----+-----------------+-------+--------+--------+
| EPG Name | Ports | POs | Switchport Mode | VLANS | Status | Reason |
+----------+-------+-----+-----------------+-------+--------+--------+

This example shows event details for the specified host. This example shows only a portion of the possible output.

$ efa vcenter debug event --host 10.24.85.111

+--------------------------------------------------------------+--------------------+
| Task: Update network configuration                           | 10.24.81.10        |
+--------------------------------------------------------------+--------------------+
| dvPort group VM network 200-220 in SRA-Dev-DC                | VM network 200-220 |
| was reconfigured.      Modified:                             |                    |
| config.defaultPortConfig.vlan: (inherited = false, vlanId    |                    |
| = 200) -> (inherited = false, vlanId = ((start = 0, end =    |                    
| 200)));    Added:     Deleted:                               |                    |
+--------------------------------------------------------------+--------------------+
| Task: Update network configuration                           | 10.24.82.20        
+--------------------------------------------------------------+--------------------+
| dvPort group VM network 200-220 in SRA-Dev-DC                | VM network 200-220 |
| was reconfigured.      Modified:                             |                    |
| config.defaultPortConfig.vlan: (inherited = false, vlanId =  |                    | 
| ((start = 200, end = 220))) -> (inherited = false, vlanId =  |                    | 
| 200);    Added:     Deleted:                                 |                    | 
+--------------------------------------------------------------+--------------------+

The following example shows typical output for the specified host.

$ efa vcenter debug tenant --host 10.24.85.111

Tenant Configuration Details for vCenter 10.24.85.111
+----------------------+-------+--------+----------------------+--------+
|     Tenant Name      | Ports | VLANs  |        Status        | Reason |
+----------------------+-------+--------+----------------------+--------+
| vcenter-10.24.85.111 |       | 2-4089 | Created Successfully |        |
+----------------------+-------+--------+----------------------+--------+
Tenant Details
 
EPG Configuration Details for vCenter 10.24.85.111
+----------+-------+-----+-----------------+-------+--------+--------+
| EPG Name | Ports | POs | Switchport Mode | VLANS | Status | Reason |
+----------+-------+-----+-----------------+-------+--------+--------+

This example shows typical, but truncated, output for debugging events for the specified host.

$ efa vcenter debug event --host 10.24.85.111

vCenter Events Total Count (4) for host 10.24.85.111
+--------------------------------------------------------------+--------------------+
|                         Description                          |       Target       |
+--------------------------------------------------------------+--------------------
| Task: Update network configuration                           | 10.24.81.10        |
+--------------------------------------------------------------+--------------------+
| dvPort group VM network 200-220 in SRA-Dev-DC                | VM network 200-220 |
| was reconfigured.      Modified:                             |                    |   
| config.defaultPortConfig.vlan: (inherited = false, vlanId    |                    | 
| = 200) -> (inherited = false, vlanId = ((start = 0, end =    |                    | 
| 200)));    Added:     Deleted:                               |                    | 
+--------------------------------------------------------------+--------------------+
| Task: Update network configuration                           | 10.24.82.20        |
+--------------------------------------------------------------+--------------------+
| dvPort group VM network 200-220 in SRA-Dev-DC                | VM network 200-220 |
| was reconfigured.      Modified:                             |                    | 
| config.defaultPortConfig.vlan: (inherited = false, vlanId =  |                    |
| ((start = 200, end = 220))) -> (inherited = false, vlanId =  |                    |
| 200);    Added:     Deleted:                                 |                    |
+--------------------------------------------------------------+--------------------+

This command sets the polling frequency to 5 minutes.

$ efa vcenter debug setting update --poll-frequency=5

vCenter service settings updated successfully

This example command sets the dead-link-clearing-time value to 4 days.

$ efa vcenter debug setting update --dead-link-clearing-time=4

vCenter service settings updated successfully

This example sets the log level to debug for this XCO instance.

$ efa vcenter debug set --level=debug

Level debug set successfully.